+2005-06-29 Matthias Clasen <mclasen@redhat.com>
+
+ * gdk/tmpl/images.sgml:
+ * gdk/tmpl/dnd.sgml:
+ * gdk/tmpl/events.sgml:
+ * gdk/tmpl/windows.sgml:
+ * gdk/tmpl/visuals.sgml:
+ * gdk/tmpl/cairo_interaction.sgml:
+ * gdk/tmpl/event_structs.sgml:
+ * gdk/tmpl/input_devices.sgml:
+ * gtk/gtk-sections.txt:
+ * gtk/Makefile.am (IGNORE_HFILES):
+ * gtk/tmpl/gtkstock.sgml: Updates.
+
2005-06-28 Ross Burton <ross@burtonini.com>
* gtk/tmpl/gtkcomboboxentry.sgml: Clarify.
Cairo Interaction
<!-- ##### SECTION Short_Description ##### -->
-
+Functions to support using Cairo
<!-- ##### SECTION Long_Description ##### -->
<para>
+<link href="http://cairographics.org">Cairo</link> is a graphics
+library that supports vector graphics and image compositing that
+can be used with GDK. Since 2.8, GTK+ does most of its drawing
+using Cairo.
+</para>
+<para>
+GDK does not wrap the Cairo API, instead it allows to create Cairo
+contexts which can be used to draw on GDK drawables. Additional
+functions allow to convert GDK's rectangles and regions into
+Cairo paths and to use pixbufs as sources for drawing operations.
</para>
<!-- ##### SECTION See_Also ##### -->
drag in progress. It is used on both source and destination sides.
</para>
-@parent_instance:
+@parent_instance: the parent instance
@protocol: the DND protocol which governs this drag.
@is_source: %TRUE if the context is used on the source side.
@source_window: the source of this drag.
Generated when a pointer or keyboard grab is broken. On X11, this happens
when the grab window becomes unviewable (i.e. it or one of its ancestors
is unmapped), or if the same application grabs the pointer or keyboard
-again.
+again. Note that implicit grabs (which are initiated by button presses)
+can also cause #GdkEventGrabBroken events.
</para>
-@type: the type of the event (%GDK_GRAB_BROKEN)
+@type: the type of the event (%GDK_GRAB_BROKEN)
@window: the window which received the event, i.e. the window
that previously owned the grab
@send_event: %TRUE if the event was sent explicitly (e.g. using <function>XSendEvent</function>).
@keyboard: %TRUE if a keyboard grab was broken, %FALSE if a pointer
grab was broken
+@implicit: %TRUE if the broken grab was implicit
@grab_window: If this event is caused by another grab in the same
application, @grab_window contains the new grab window. Otherwise
@grab_window id %NULL.
which are not ancestors of each other and the window is part of
the ancestor chain between one of these windows and their least
common ancestor.
-@GDK_NOTIFY_UNKNOWN:
+@GDK_NOTIFY_UNKNOWN: an unknown type of enter/leave event occurred.
<!-- ##### ENUM GdkPropertyState ##### -->
<para>
event is received each time the mouse moves. However, if the application
spends a lot of time processing the event (updating the display, for example),
it can easily lag behind the position of the mouse. When using the
-%GDK_POINTER_MOTION_HINT_MASK the server will only send a single %GDK_MOTION_NOTIFY
-event (which is marked as a hint) until the application asks for more, by calling
-gdk_window_get_pointer().
-</para>
-
-@GDK_EXPOSURE_MASK:
-@GDK_POINTER_MOTION_MASK:
-@GDK_POINTER_MOTION_HINT_MASK:
-@GDK_BUTTON_MOTION_MASK:
-@GDK_BUTTON1_MOTION_MASK:
-@GDK_BUTTON2_MOTION_MASK:
-@GDK_BUTTON3_MOTION_MASK:
-@GDK_BUTTON_PRESS_MASK:
-@GDK_BUTTON_RELEASE_MASK:
-@GDK_KEY_PRESS_MASK:
-@GDK_KEY_RELEASE_MASK:
-@GDK_ENTER_NOTIFY_MASK:
-@GDK_LEAVE_NOTIFY_MASK:
-@GDK_FOCUS_CHANGE_MASK:
-@GDK_STRUCTURE_MASK:
-@GDK_PROPERTY_CHANGE_MASK:
-@GDK_VISIBILITY_NOTIFY_MASK:
-@GDK_PROXIMITY_IN_MASK:
-@GDK_PROXIMITY_OUT_MASK:
-@GDK_SUBSTRUCTURE_MASK:
-@GDK_SCROLL_MASK:
+%GDK_POINTER_MOTION_HINT_MASK the server will only send a single
+%GDK_MOTION_NOTIFY event (which is marked as a hint) until the application
+asks for more, by calling gdk_window_get_pointer().
+</para>
+
+@GDK_EXPOSURE_MASK: receive expose events
+@GDK_POINTER_MOTION_MASK: receive all pointer motion events
+@GDK_POINTER_MOTION_HINT_MASK: see the explanation above
+@GDK_BUTTON_MOTION_MASK: receive pointer motion events while any button is pressed
+@GDK_BUTTON1_MOTION_MASK: receive pointer motion events while 1 button is pressed
+@GDK_BUTTON2_MOTION_MASK: receive pointer motion events while 2 button is pressed
+@GDK_BUTTON3_MOTION_MASK: receive pointer motion events while 3 button is pressed
+@GDK_BUTTON_PRESS_MASK: receive button press events
+@GDK_BUTTON_RELEASE_MASK: receive button release events
+@GDK_KEY_PRESS_MASK: receive key press events
+@GDK_KEY_RELEASE_MASK: receive key release events
+@GDK_ENTER_NOTIFY_MASK: receive window enter events
+@GDK_LEAVE_NOTIFY_MASK: receive window leave events
+@GDK_FOCUS_CHANGE_MASK: receive focus change events
+@GDK_STRUCTURE_MASK: receive events about window configuration change
+@GDK_PROPERTY_CHANGE_MASK: receive property change events
+@GDK_VISIBILITY_NOTIFY_MASK: receive visibility change events
+@GDK_PROXIMITY_IN_MASK: receive proximity in events
+@GDK_PROXIMITY_OUT_MASK: receive proximity out events
+@GDK_SUBSTRUCTURE_MASK: receive events about window configuration changes of
+ child windows
+@GDK_SCROLL_MASK: receive scroll events
@GDK_ALL_EVENTS_MASK: the combination of all the above event masks.
<!-- ##### MACRO GDK_CURRENT_TIME ##### -->
The #GdkImage struct contains information on the image and the pixel data.
</para>
-@parent_instance:
+@parent_instance: the parent instance
@type: the type of the image.
@visual: the visual.
@byte_order: the byte order.
@depth: the depth of the image, i.e. the number of bits per pixel.
@bpp: the number of bytes per pixel.
@bpl: the number of bytes per line of the image.
-@bits_per_pixel:
+@bits_per_pixel: the number of bits per pixel.
@mem: the pixel data.
-@colormap:
+@colormap: the #GdkColormap associated with the image
<!-- ##### FUNCTION gdk_image_new ##### -->
<para>
to configure various aspects of the device.
</para>
-@parent_instance:
+@parent_instance: the parent instance
@name: the name of this device.
@source: the type of this device.
@mode: the mode of this device
Deprecated equivalent of g_object_ref().
</para>
-@v:
-@Returns:
+@v: a #GdkVisual
+@Returns: the same visual
<!-- ##### MACRO gdk_visual_unref ##### -->
Deprecated equivalent of g_object_unref().
</para>
-@v:
+@v: a #GdkVisual
<!-- ##### FUNCTION gdk_visual_get_screen ##### -->
@min_width: minimum width of window (or -1 to use requisition, with #GtkWindow only)
@min_height minimum height of window (or -1 to use requisition, with #GtkWindow only)
-@min_height:
@max_width: maximum width of window (or -1 to use requisition, with #GtkWindow only)
@max_height: maximum height of window (or -1 to use requisition, with #GtkWindow only)
@base_width: allowed window widths are @base_width + @width_inc * N where N is any integer (-1 allowed with #GtkWindow)
@dy:
+<!-- ##### FUNCTION gdk_window_move_region ##### -->
+<para>
+
+</para>
+
+@window:
+@region:
+@dx:
+@dy:
+
+
<!-- ##### FUNCTION gdk_window_reparent ##### -->
<para>
Deprecated equivalent to gdk_draw_drawable(), see that function for docs
</para>
-@drawable:
-@gc:
-@x:
-@y:
-@source_drawable:
-@source_x:
-@source_y:
-@width:
-@height:
+@drawable: a #GdkDrawable
+@gc: a #GdkGC sharing the drawable's visual and colormap
+@drawable: a #GdkDrawable
+@x: X position in @drawable where the rectangle should be drawn
+@y: Y position in @drawable where the rectangle should be drawn
+@source_drawable: the source #GdkDrawable, which may be the same as @drawable
+@source_x: X position in @src of rectangle to draw
+@source_y: Y position in @src of rectangle to draw
+@xdest: X position in @drawable where the rectangle should be drawn
+@ydest: Y position in @drawable where the rectangle should be drawn
+@width: width of rectangle to draw, or -1 for entire @src width
+@height: height of rectangle to draw, or -1 for entire @src height
<!-- ##### FUNCTION gdk_window_raise ##### -->
@GDK_BUTTON5_MASK: the fifth mouse button.
@GDK_RELEASE_MASK: not used in GDK itself. GTK+ uses it to differentiate
between (keyval, modifiers) pairs from key press and release events.
-@GDK_MODIFIER_MASK:
+@GDK_MODIFIER_MASK: a mask covering all modifier types.
<!-- ##### FUNCTION gdk_window_get_parent ##### -->
<para>
gtkintl.h \
gtkkeyhash.h \
gtkmarshal.h \
+ gtkmnemonichash.h \
gtkpathbar.h \
gtkprivate.h \
gtkrbtree.h \
GTK_IS_CALENDAR_CLASS
GTK_CALENDAR_GET_CLASS
<SUBSECTION Private>
+GtkCalendarPrivate
gtk_calendar_get_type
</SECTION>
<FILE>gtkiconview</FILE>
<TITLE>GtkIconView</TITLE>
GtkIconView
-GtkIconViewPrivate
GtkIconViewForeachFunc
gtk_icon_view_new
gtk_icon_view_new_with_model
gtk_icon_view_scroll_to_path
gtk_icon_view_get_visible_range
<SUBSECTION Dnd>
+GtkIconViewDropPosition
gtk_icon_view_enable_model_drag_source
gtk_icon_view_enable_model_drag_dest
gtk_icon_view_unset_model_drag_source
GTK_ICON_VIEW
<SUBSECTION Private>
gtk_icon_view_get_type
+GtkIconViewPrivate
</SECTION>
<SECTION>
+<!-- ##### MACRO GTK_STOCK_INFO ##### -->
+<para>
+The "Info" item.
+<inlinegraphic fileref="stock_info_24.png" format="PNG"></inlinegraphic>
+</para>
+
+@Since: 2.8
+
+
<!-- ##### MACRO GTK_STOCK_ITALIC ##### -->
<para>
The "Italic" item.
+<!-- ##### MACRO GTK_STOCK_FULLSCREEN ##### -->
+<para>
+The "Fullscreen" item.
+<inlinegraphic fileref="stock_fullscreen_24.png" format="PNG"></inlinegraphic>
+</para>
+
+@Since: 2.8
+
+
+
+<!-- ##### MACRO GTK_STOCK_LEAVE_FULLSCREEN ##### -->
+<para>
+The "Leave Fullscreen" item.
+<inlinegraphic fileref="stock_leave_fullscreen_24.png" format="PNG"></inlinegraphic>
+</para>
+
+@Since: 2.8
+
+
+
+
+
+
projects / gtk4.git / commitdiff